home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Sun Solutions 2000 #2
/
Sun Solutions CD (Volume 2 2000)(Special Focus - Java Technologies)(Disc 1).ISO
/
products
/
bin
/
java2
/
win32
/
README
< prev
next >
Wrap
Text File
|
2000-01-05
|
12KB
|
270 lines
README
The Java(R) 2 Runtime Environment
Standard Edition Version 1.2.1
The Java(R) 2 runtime environment contains the Java virtual machine,
runtime class libraries, and Java application launcher that are
necessary to run programs written in the Java progamming language.
It is not a development environment and doesn't contain development
tools such as compilers or debuggers. For development tools, see the
Java 2 SDK Standard Edition.
The Win32 version of the Java 2 runtime environment includes the Java
Plug-in product which enables support for the Java 2 platform on
recent releases of Netscape Navigator and Microsoft Internet Explorer.
When you install the Java 2 runtime environment, you can install the
Plugin as well. For more information, including information about the
Java Plug-in for Solaris, see the Plug-in web page at
http://java.sun.com/products/plugin/.
The Win32 version of the Java 2 runtime environemnt includes a
Symantec JIT compiler, Copyright (c) 1996-1999 by Symantec
Corporation. All rights reserved.
=======================================================================
Deploying Java Applications with the Java 2 Runtime Environment
=======================================================================
An Java-language application, unlike an applet, cannot rely on a web
browser for installation and runtime services. When you deploy a Java
application, your software bundle will probably consist of the
following parts:
Your own class, resource, and data files.
A runtime environment.
An installation procedure or program.
You already have the first part, of course. The remainder of this
document covers the other two parts. See also the Notes for Developers
page on the Java Software website:
http://java.sun.com/products/jdk/1.2/runtime.html
-----------------------------------------------------------------------
Runtime Environment
-----------------------------------------------------------------------
To run your application, a user needs a Java virtual machine, the Java
platform core classes, and various support programs and files. This
collection of software is known as a runtime environment.
The Java 2 SDK software can serve as a runtime environment. However,
you probably can't assume your users have the Java 2 SDK software
installed, and your Java 2 SDK software license doesn't allow you to
redistribute SDK software files.
To solve this problem, Sun provides the Java 2 runtime environment
as a free, redistributable runtime environment, available for Win32 and
Solaris systems. (The Java 2 runtime environment should not be confused
with the Java 2 SDK's own internal, non-redistributable version of the
runtime environment housed in the jdk1.2/jre directory.)
The Win32 versions comes with a built-in installation program
suitable for end-users. Solaris versions require the developer to
provide installation support.
The Java 2 runtime environment for Win32 is available both with and
without international support. The non-international version is much
smaller, but is suitable only for English-speaking users.
The final step in the deployment process occurs when the software is
installed on individual user system. Installation consists of copying
software onto the user's system, then configuring the user's system to
support that software.
This step includes installing and configuring the runtime environment.
If you use the Java 2 runtime environment, you must make sure that your
installation procedure never overwrites an existing installation, unless
the existing runtime environment is an older version.
The Win32 version of the Java 2 runtime environment is distributed as a
self-installing executable. A simple way to redistribute the Java 2
runtime environment is to include this executable in your software
bundle. You can then have your installation program run the executable,
or simply instruct the user to install the Java 2 runtime environment
before installing the rest of your bundle.
The Win32 installation program records program information in the
Windows Registry. This registry information includes the software
version, which you should compare with the Java 2 runtime environment
version in your software bundle. For more information, refer to the
Notes for Developers on the Java Software web site:
http://java.sun.com/products/jdk/1.2/runtime.html
A more sophisticated approach is to install the Java 2 runtime
environment on your own system, then copy the files you need into your
own installation set for redistribution. If you choose this approach,
you must include all files except those described as "optional" in the
"Redistrubition of the Java 2 runtime environment" section of this
README. The Java 2 Runtime Environment software can only be
redistributed if all "required" files are included. See the LICENSE
file for specifics.
If you use this approach, do not try to emulate the installation steps
performed by the Java 2 Runtime Environment installer. You might "break"
an existing runtime environment installation by missing a new or
undocumented installation step. Instead, you should include the Java 2
Runtime Environment files in your own application directory. In
effect, your application has its own "private" copy of the Java 2
Runtime Environment.
The Win32 Java 2 Runtime Environment now includes Java Plug-in software,
which enables Netscape Navigator and Microsoft Internet Explorer to
support the Java 2 platform. To develop applets that use Java Plug-in
software, see the Java Plug-in product page on the Java Software web
site:
http://java.sun.com/products/plugin/
You can also find information about the Java Plug-in for Solaris on
this web page.
-----------------------------------------------------------------------
Winsock Deployment
-----------------------------------------------------------------------
If your application uses the networking classes, it may not run
reliably under Winsock 1.1. If your networking application must support
Windows 95, which includes Winsock 1.1, you will want to include a
Winsock 2.0 install in your installation procedure. (Windows NT 4.0 and
Windows 98 include Winsock 2.0.) To provide Winsock 2.0, you need the
Microsoft Windows Sockets 2.0 Software Development Kit. This free
software can be downloaded from the following addresses:
http://www.microsoft.com/win32dev/netwrk/winsock2/ws295sdk.html
ftp://ftp.microsoft.com/bussys/WinSock/winsock2/
=======================================================================
Redistribution of this Java 2 Runtime Environment
=======================================================================
The term "vendors" used here refers to licensees, developers, and
independent software vendors (ISVs) who license and distribute the
Java 2 runtime environment with their programs.
Vendors may not redistribute this Java 2 runtime environment except in
the limited circumstances described in the accompanying Binary Code
License agreement, contained in the LICENSE file in the download
bundle.
Vendors must follow the terms of the Binary Code License agreement
which include, among others:
- Arbitrary subsetting of the Java 2 runtime environment is not
allowed. See the section below entitled "Required vs. Optional Files"
for those files that may be optionally omitted from redistributions
of the runtime environment.
- You must include in your product's license the provisions called
out in the Binary Code license.
-----------------------------------------------------------------------
Required vs. Optional Files
-----------------------------------------------------------------------
Licensees must follow the terms of the accompanying LICENSE.
The files that make up the Java 2 runtime environment are divided into
two categories: required and optional. Files that are marked "optional"
here do not need to be included in redistributions of the Java 2
runtime environment with the licensee's program.
The following sections contain lists of the files, for both Win32
and Solaris platforms, that may optionally be omitted from
redistributions with the Java 2 runtime environment. All files not
in these lists of optional files must be included in redistributions
of the runtime environment.
The Java 2 runtime environment includes the bin and lib directories
which both must reside in the same directory, called <runtime-dir> in
the lists below. All paths are relative to the <runtime-dir> directory.
Note that in the case of the Win32 Java 2 runtime environment, the
native code C runtime library, msvcrt.dll, is located in the Windows
system directory. The location of this directory varies on different
operating systems, but is usually
- winnt\system32 on Windows NT
- windows98\system on Windows 98
- windows\system on Windows 95
This file should be included in redistributions of the Win32 version
of the Java 2 runtime environment.
-----------------------------------------------------------------------
Win32 Optional Files and Directories
-----------------------------------------------------------------------
All font properties files in the lib directory other than the default
lib\font.properties file are optional, and vendors may choose not to
include them in redistributions of the Java 2 Runtime Environment. In
addition, the following may be optionally excluded from redistributions:
bin\beans.ocx
Plugin ActiveX control
lib\jaws.jar
Plugin classes
lib\i18n.jar
Character conversion classes and all other locale support
lib\ext\
Directory containing extension jar files
bin\symcjit.dll
JIT compiler
bin\rmid.exe
Java RMI Activation System Daemon
bin\rmiregistry.exe
Java Remote Object Registry
bin\tnameserv.exe
Java IDL Name Server
bin\keytool.exe
Key and Certificate Management Tool
bin\policytool.exe
Policy File Creation and Management Tool
-----------------------------------------------------------------------
Solaris Optional Files and Directories
-----------------------------------------------------------------------
The directory <sys> varies depending on the hardware architecture
implementation. It will be either sparc or i386. The Solaris version
of the Java 2 runtime environment ships with support for both green
threads and native threads. Files providing this support are in the
directories lib/<sys>/green_threads and lib/<sys>/native_threads
respectively. Although at least one of these directories and its
contents must be included in redistributions of the Java 2 runtime
environment, vendors do not have to include both.
All font properties files in the lib directory other than the default
lib/font.properties file for Solaris 2.6 and the default
lib/font.properties.5.5.1 file for Solaris 2.5.1 are optional, and
vendors may choose not to include them in redistributions of the
Java 2 runtime environment. In addition, the following may be
optionally excluded from redistributions:
lib/i18n.jar
Character conversion classes and all other locale support
lib/<sys>/libsunwjit.so
JIT compiler
lib/ext/
Directory containing extension jar files
bin/rmid
Java RMI Activation System Daemon
bin/rmiregistry
Java Remote Object Registry
bin/tnameserv
Java IDL Name Server
bin/keytool
Key and Certificate Management Tool
bin/policytool
Policy File Creation and Management Tool
-----------------------------------------------------------------------
Copyright (c) 1998-1999 Sun Microsystems(tm), Inc.
901 San Antonio Road, Palo Alto, CA 94303-4900
All rights reserved.